home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audio / ALgetfd.z / ALgetfd
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. AAAALLLLggggeeeettttffffdddd((((3333ddddmmmm))))                                                      AAAALLLLggggeeeettttffffdddd((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ALgetfd - (obsolete) get the file descriptor for an audio port
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////aaaauuuuddddiiiioooo....hhhh>>>>
  13.  
  14.      iiiinnnntttt AAAALLLLggggeeeettttffffdddd((((AAAALLLLppppoooorrrrtttt ppppoooorrrrtttt))))
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRR
  17.      _p_o_r_t   expects the AAAALLLLppppoooorrrrtttt structure whose file descriptor you desire.
  18.             This structure is the returned value of an AAAALLLLooooppppeeeennnnppppoooorrrrtttt((((3333ddddmmmm)))) call.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      AAAALLLLggggeeeettttffffdddd is obsolete and is provided for backward compatibility. The
  22.      preferred function is aaaallllGGGGeeeettttFFFFDDDD((((3333ddddmmmm)))).
  23.  
  24.      AAAALLLLggggeeeettttffffdddd(((()))) returns a file descriptor that you can use to construct the
  25.      arguments to a sssseeeelllleeeecccctttt((((2222))))  or ppppoooollllllll((((2222)))) call. These calls are used when you
  26.      want to give up control of the CPU (letting other processes use the CPU)
  27.      until the device fills/empties the audio port buffer past the fillpoint.
  28.      At that time, sssseeeelllleeeecccctttt((((2222)))) and ppppoooollllllll((((2222)))) return, and your code can continue
  29.      processing the audio ports.  If the device has already filled/emptied the
  30.      audio port buffer past the fillpoint when you make the call, control
  31.      returns to your program immediately.
  32.  
  33.      When using sssseeeelllleeeecccctttt((((2222)))), an input port's file descriptor is used in a read
  34.      fdset and an output port's file descriptor is used in a write fdset.
  35.  
  36.      When using ppppoooollllllll((((2222)))), an input port's file descriptor is used with the
  37.      POLLIN event flag and an output port's file descriptor is used with a
  38.      POLLOUT event flag.
  39.  
  40.      Several AL functions implicitly change the current fillpoint value.
  41.      Therefore, AAAALLLLsssseeeettttffffiiiillllllllppppooooiiiinnnntttt((((3333ddddmmmm)))) must be called immediately before a
  42.      sssseeeelllleeeecccctttt((((2222)))) or ppppoooollllllll((((2222)))) call which uses an audio file descriptor.
  43.  
  44.      AAAALLLLggggeeeettttffffdddd((((3333ddddmmmm)))) can fail for the following reason:
  45.  
  46.      AAAALLLL____BBBBAAAADDDD____PPPPOOOORRRRTTTT   _p_o_r_t is either invalid or null.
  47.  
  48. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  49.      Upon successful completion, AAAALLLLggggeeeettttffffdddd((((3333ddddmmmm)))) returns a valid file descriptor.
  50.      Otherwise, AAAALLLLggggeeeettttffffdddd((((3333ddddmmmm)))) returns -1 and sets an error number which can be
  51.      retrieved with oooosssseeeerrrrrrrroooorrrr((((3333CCCC)))).
  52.  
  53. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  54.      ALsetfillpoint(3dm), ALgetfillpoint(3dm), ALopenport(3dm), select(2),
  55.      poll(2), oserror(3C)
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.